home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / msgscan.arc / MSGSCAN.DOC < prev    next >
Encoding:
Text File  |  1988-03-30  |  5.6 KB  |  119 lines
  1.            MsgScan.com version 3c  Copyright (C) 1988, G.K. Pace
  2.                         All Rights Reserved!
  3.  
  4. General Description...
  5.  
  6.  MsgScan is a simple program for generating a text file containing the
  7. names of those persons having unrecieved messages on a Fido(r) (or similar)
  8. Bulletin Board Service system.  It was written specifically for use on
  9. a system using Tom Jennings Fido12 software,but has been tested for use
  10. on an OPUS system as well.  On my Fido12 system, I have Msgscan scanning
  11. my local message areas and outputting a welcome2.bbs file, so that upon
  12. signon, a user is alerted to any local messages he might have waiting
  13. for him/her. I run Msgscan thru Fido12s' "G" event which occurs each time
  14. a user logs off, so that the welcome2.bbs file is always current.
  15.  MsgScan can scan upto 200 message areas for messages, and output upto
  16. 500 lines of "who-has-what-where"..., comparing each message to the
  17. list of users of your system. Altho MsgScan is designed for speed,
  18. obviously the more you scan, the longer it takes... Those who wish to
  19. scan Echo-Mail areas will probably find that it is best to do it once
  20. a day, rather than after each caller.
  21.  
  22. Setting it up for use...
  23.  
  24.  MsgScan has been designed to be flexible in application, and thus requires
  25. that you give it the information it requires to do what you want done.
  26.  The following are required!
  27.  - A Fido(r) or OPUS BBS system...
  28.  - Messages...
  29.  - Users...
  30.  - A control file indicating what areas you want scanned.
  31.  - The name you want to call the output file.
  32.  - A caller.lst.
  33.  
  34.  The caller list is generated by using the accompanying utility, ScanLst
  35. (for Fido12) or ScanUbbs (for OPUS). It must be in the same directory as
  36. your Caller.sys or User.bbs file. These utilities scan thru your user base
  37. outputting a file named Caller.lst containing the information MsgScan needs.
  38.  These utilities can be run from your BBS system batch file, as an event,
  39. as often as you feel necessary to keep the caller list up to date. (I run
  40. it nightly on my system...)
  41.  
  42.  The name of the output file is specified on the command line...
  43.  
  44.  The name of the control file you are using is specified on the command
  45. line... The control file is an ascii file you will have to create.
  46. You can have several control files, and generate different output files at
  47. different event schedules if you desire...
  48.  
  49.  The control file can be named anything (within legal DOS limits) you wish,
  50. the text of the file must be in the form:
  51. message_area_path<space>message_area_number
  52.  As an example of what should be in the control file is:
  53. c:\Fido\Msg\Local\ 1
  54. c:\fido\echo\Vietnam_vets\ 3
  55. \Fido\Net\Mail\ 6
  56.  You may scan multiple areas if you wish, (each adds time tho) and the area
  57. number is just used to tell the users where the messages were found.
  58.  
  59.  The command line argument MsgScan requires is of the form:
  60. MsgScan<space>output_filename<space>control_filename
  61. As an example,you might use: Msgscan Welcome2.bbs Msgscan.ctl
  62.  
  63.  If you have information you regularly post in your Welcome2.bbs file,
  64. you can place your information in a file named welcome2, set Msgscan to
  65. output a file named FOO, and follow the msgscan event with a DOS command
  66. such as: Copy Welcome2 + Foo Welcome2.bbs.
  67.  
  68. Misc. information...
  69.  
  70.  MsgScan will stop scanning an area, after it has tried 36 times to open
  71. a message...  This means that if an area only has messages #10,25,50,59
  72. and 75 in it, MsgScan will find them all... but if it has the messages
  73. #10,25,50,87,90,112 and 135 in it, MsgScan will not scan any message past
  74. number 50...
  75.  
  76.  My primary intent with MsgScan is to provide a usefull utility, which
  77. functions fast enough to be run each time a user logs off. I will continue
  78. to pursue speeding it up...  I am always interested in making it more
  79. flexible, and usefull, so experiements into additional features will
  80. continue...
  81.  
  82. Legalities...
  83.  
  84.  As the author and owner of Msgscan, I retain all commercial rights to the
  85. program and its previous or subsequent versions. If you are operating a
  86. Public Access BBS at NO charge to your users, you may have USE of MsgScan
  87. on your system at no cost, however if you find it a useful utility, and
  88. are interested in recieving future upgrades, notices of other utilities,
  89. etc., a donation <$10.00 is suggested> would be appreciated...!
  90.  You are Not authorized to sell or otherwise realize any monetary return
  91. from it, its' use, or transfer to others.
  92.  
  93.  If you are operating a commercial,business, or governmental type BBS
  94. system, you may use MsgScan on a temporary basis for the purpose of
  95. evaluating its' value to you. Permission for continued USE on your
  96. system may be obtained upon application and payment of a small fee.
  97.  
  98.  The USE of MsgScan for any purpose not specifically mentioned above is
  99. NOT authorized. Authorization for any other use must be applied for, and
  100. specific details must be provided!
  101.  
  102.  NOTICE: MsgScan has been written for use with Fido12 systems, and tested
  103. on an IBM-XT CLONE. I will not accept responsibility for any damages
  104. which might occur in its' use, and do not offer any warranty of its'
  105. suitability for use. I leave the determination of its' suitability for
  106. use to you, if you like it use it, if you don't like it, don't use it...
  107.  
  108.  Comments on MsgScan, and application for authorization of its' use may be
  109. addressed to:
  110.                                G.K. Pace
  111.                                6921 Poplar Ridge Road
  112.                                Lewisville, N.C. 27023
  113.                                FidoNet(r) Node 1:151/60
  114.  
  115.  Note: Fido, and FidoNet are trademarks owned by Tom Jennings, with out
  116. whom none of this would be possible...!
  117.  
  118.  
  119.